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services : 

1.  Analysis  of  module  prologues  for  completeness  and 
adherence  to  standards 

2.  Parsing  of  Program  Design  Language  (PDL)  for  proper 
expression  of  the  design 

3.  Generation  of  Test  Specification  charts  from  PDL. 

The  user's  manual  provides  information  on  the  set-up  and  execution  of  the 
Code  Auditor. 

1.2  BACKGROUND  INFORMATION 

Module  prologue,  PDL,  and  Test  Specifications  are  design  and  documentation 
aids  accompanying  each  module  created  for  the  Central  Flow  Control  (CFC) 
project,  following  standards  defined  in  the  CFC  Quality  Assurance  Plan. 

A sample  module  prologue  appears  in  Figure  1-1;  an  example  of  PDL  appears 
in  Figure  1-2.  A sample  Test  Specification  appears  in  Figure  1-3,  which 
has  been  generated  from  the  PDL  in  Figure  1-2. 

1.3  REFERENCES 

Central  Flow  Control  Quality  Assurance  Plan  - CSC/SD-78/6060 . 
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••*  METHOD  NARRATIVE-  MARES  CALLS  RAEMSG  TO  HAVE  A DIAGNOSTIC’ ' 

••  ERROR  MESSAGE  WRITTEN  FROM  A LIBRARY  OF  EP.PDR  " ! 

••  MESSAGES  TO  A PRINT  FILE.  MARES  ANALYZES  1 HE  CODE  " i 

•»  RETURNED  FROM  RAEMSG  AND  TAKES  APPROPRIATE  ACTION  " 1 
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'MODULE  MARES 

•CALL  RAEMSG  TO  WRITE  ERROR  MESSAGE 

•IF  THE  ERROR  MESSAGE  WAS  NOT  IN  THE  ERROR  FILE 

• SET  UP  THE  RAEMSG  CALLING  SEQUENCE  TO  WRITE 

• THE  NOT  FOUNO  MESSAGE 

• CALL  RAEMSG  TO  WRITE  THE  MESSAGE 

•ENDIF . ..  \ 

•IF  AN  ERROR  OCCURRED 

• SET  ABORT  TO  THE  APPROPRIATE  VALUE  FOR  A READ 

• OR  WRITE  ERROR  OR  MESSAGE  NOT  FOUND 
•FNDIF 

• E NDMGDULE  MARES 


•*  END  PDL 


Figure  1-2.  Program  Design  Language 
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AUTOMATED  CODE  AUDITOR 
TEST  PROCEDURE  ANALYSIS 


*********ti»<r*#***ii»***t*4**»t**«**«*****m********t*+************************ 

on  * IN  I T * PARAMETER  TEST  CASES 

PATH*  CONSTR  * *1*2*3*4*5*6*7*8*9 

***************** * ************* * ******************************************** ****** 

1 * IE-TRUE  * THE  ERROR  MESSAGE  HAS  NOT  INTH  ********* 

2 *!E— PALSE*  THE  ERROR  MESSAGE  WAS  NOT  INTH  ********* 

3 * f P— TPIIE  * AN  ERROR  OCCURRED  ********* 


'♦  MF-FALSE*  AN  ERROR  OCCURRED 


********* 


********************************************************************************** 

MODUL  E=  MARES  DATE=  10/26/78  PAGE  1 


Figure  1-3.  Test  Specification  Chart 
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SECTION  2 - PROGRAM  OPERATION 

2.1  PROGRAM  OPEPATIOII  OVERVIEW 

u 

Analysis  of  module  prologues  is  accomplished  through  simple  parsing  of 
keywords  and  associated  text.  Prologue  keywords  fall  into  two  classes: 
major  and  minor.  Referring  to  the  fourth  line  of  Figure  1-1,  ENGLISH  is 
a major  keyword  and  NAME-  immediately  thereafter  is  a minor  keyword.  Once 
a major  keyword  is  recognized  by  the  Code  Auditor,  comparison  is  made  for 
the  associated  minor  keyword(s)  and  descriptive  text.  Keywords  must  begin 
in  specific  card  columns  and  must  be  spelled  correctly.  Any  character 
string  not  meeting  these  criteria  is  considered  descriptive  text.  Errors 
in  card  column  alignment  or  missing  keywords  are  flagged  with  an  error 
message . 

The  Program  Design  Language  (PDL)  logical  constructs  are  described  in  Section 
3. 2. 1.2  of  the  CFC  Quality  Assurance  Plan.  Parsing  of  PDL  by  the  Code  Auditor 
involves  the  following  groups  of  keywords : 

IF/ENDIF 

IF/ELSE/ENDIF  / 

DO-WHILE/ENDDO 
REPEAT/UNTIL 
DO-CASE/ENDDO . 


These  groups  of  keywords  are  essentially  delimeters  of  logical  flow. 

For  example,  whenever  the  keyword  DO-CASE  is  recognized,  there  must  also 
appear  a subsequent  ENDDO  beginning  in  the  same  card  column.  This  relation- 
ship applies  to  all  the  keyword  groups.  Figure  1-2  contains  an  example  of  PDL. 

i 

i 
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The  Test  Specification  chart  i:;  generated  during  the  pursing  of  PPL. 
(Pefer  to  figure  1-S,  which  i:.  a Test  Specification  Chart  generated 
from  the  PDL  in  figure  1-?.)  becision-to-decision  paths  are  created  as 
PDL  keywords  are  recognized.  The  Code  Auditor  assigns  a number  to  each 
of  these,  which  is  printed  both  on  the  left  side  of  the  Test  Specifica- 
tion chart  and  on  the  right  side  of  the  PDL  report.  The  first  thirty 
characters  following  an  If,  DO-WHILE,  and  DO-CASE  are  printed  on  the 
Test  Specification  Chart  to  help  identify  the  decision-to-decision 
paths . 
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SECTION  3 - PROGRAM  INPUTS 


3.1  CONTROL  CARDS 

The  control  card  data  set  is  read  from  the  SYSIN  file  and  should  appear 
as  follows : 


START  $ 

MODULE  CARDS  • 

TERM  $ 

The  information  on  control  cards  may  appear  between  columns  1 and  72 
inclusive.  The  $ delimeter  is  optional  on  each  card';  if  present,  the 
remainder  of  the  card  is  ignored  and  may  be  used  for  comments . 

The  START  card  signals  the  beginning  of  the  control  card  set  and  should 
not  appear  elsewhere.  The  format  is: 

START  $ 

The  MODULE  card  identifies  the  name  and  specifies  options  for  a module  to 
be  analyzed.  At  least  one  and  not  more  than  one  hundred  of  these  cards  must 
appear  in  the  control  card  set . The  format : 

MODULE  = name,  option,  option,  option  $ 
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mm/m 

LENGTH 

(BYTES) 

VALUES 

BuS9 

DESCRIPTION 

name 

8 

■ 1 

R 

name  of  a member  in  the  Prologue/PDL 

HP 

library 

option 

4 

1 

0 

list  prologue  only 

0 

list  PDL  only 

0 

generate  and  list  Test 

■ 

Specification  charts 

Special  attention  must  be  given  to  the  LTPA  parameter.  If  LTPA  is  specified 
on  the  first  MODULE  card.  Test  Specification  charts  will  be  generated  and  listed 
for  all  modules.  Similarly,  if  LTPA  is  not  present  on  the  first  MODULE  card, 
no  Test  Specification  charts  will  be  listed  for  any  module. 

If  no  optional  parameters  accompany  a module  name,  only  diagnostics  will  be 
listed.  If  LPRL  and  LSRC  are  present,  the  listing  includes  both  Prologue 
and  PDL. 

The  TERM  card  identifies  the  end  of  the  control  card  set  and  should  not 
appear  elsewhere . The  format  is : 

TERM  $ 

3.1.1  Control  Card  Examples 

To  generate  Test  Specification  Charts 
START  $ 

MODULE  = MODI,  LTPA  $ 

MODULE  = MOD 2 $ 

TERM  $ 
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Test  Specification  Charts  are  to  be  generated  and  listed  for  modules 
MODI  and  M0D2,  from  their  respective  PDL.  Their  prologues  and  PTL  will 
be  analyzed  and  only  diagnostics  (if  any)  will  be  listed. 


To  Analyze  and  List  the  Prologue : 


START  $ 

MODULE  = MODI,  LPRL  $ 
TERM  $ 


The  MODI  Prologue  is  to  be  analyzed  and  listed  with  diagnostics. 


To  Analyze  and  List  the  PDL: 


START  $ 

MODULE  = M0D2 , LSRC  $ 
TERM  $ 


The  M0D2  PDL  is  to  be  listed.  The  M0D2  Prologue  will  be  analyzed  and 
diagnostics  (if  any)  will  be  listed. 


For  All  Code  Auditor  Services : 


START  $ 

MODULE  = MODI,  LPRL,  LSRC,  LTPA  $ 
MODULE  = M0D2 , LSRC,  LPRL  $ 

MODULE  = M0D3 , LPRL,  LSRC  $ 

TERM  $ 


The  prologues  and  PDL  of  modules  MODI , M0D2 , and  M0D3  are  t be  analyzed 
and  listed  with  diagnostics.  Test  Specification  Charts  are  to  be  generated 
from  PDL  and  listed  for  all  three  modules . 


For  Minimal  Listing: 

START  $ 

MODULE  = MODI  $ 
TERM  $ 
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The  PDL  and  prologue  of  MODI  is  to  be  analyzed,  but  not  listed.  Only 
diagnostics  (if  any)  are  to  be  listed. 


3.2  DATA  CARDS 

Data  cards  are  not  used  by  the  Code  Auditor. 

3 . 3 DATA  SETS 

The  Automated  Code  Auditor  uses  the  following  data  sets : 

• Control  Card  Set 

• Prologue/PDL  Library  Set 

• Prologue/PDL  Report  Set 

• Diagnostic  Error  Message  Set 

3.3.1  Control  Card  Set 

Control  cards  are  input  through  the  sequential  file  defined  by  the  SYSIN  DD 
card.  Logical  records  are  80  bytes  long  and  can  be  blocked  by  the  user.  No 
specific  hardware  device  must  be  used  for  the  control  card  file. 

3.3.2  Pr61ogue/PDL  Library  Set 

This  input  file  is  defined  by  the  DATAIN  DD  card.  The  prologue/PDL  library 
must  be  a partitioned  data  set  whose  members  are  modules  to  be  analyzed. 

Each  module  should  be  composed  of  a prologue  followed  by  PDL.  The  logical 
record  length  is  80  bytes,  and  the  records  should  be  blocked. 

3.3.3  Prologue/PDL  Report  Set 

The  Automated  Code  Auditor  has  only  one  output,  the  Prologue/PDL  Report  Set, 
identified  by  the  MARPTLST  DD  card.  Logical  record  length  is  133  bytes.  As 


i 
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this  file  is  intended  to  be  a print  file,  the  record  format  is  F'BA, 
fixed-length  blocked  records  with  ANf'.I  printer  control  characters. 

3.3.4  Diagnostic  Error  Message  Sot 

This  file  is  a partitioned  data  set  whose  members  each  contain  text 
for  a diagnostic  error  message.  Thi::  input  file,  identified  via  the 
MAEMSG  DD  card,  is  crucial  to  the  Code  Auditor  and  must  be  disk- 
resident  whenever  that  program  is  executed.  Each  member  is  one  80 
byte  fixed-length  record. 

3.4  JOB  CONTROL  LANGUAGE 

The  following  sections  describe  the  Job  Control  Language  (JCL) 
available  for  execution  of  MACA  and  its  use. 


3.4.1  MACA  Procedure 


The  MACA  catalogued  procedure  is  a member  of  SYS2.PR0CLIB,  and  contains 

the  following: 

//MACA  PROC  DATAIN= 

//  EXEC  PGM=MACA ,REGION=170K 
//STEPLIB  DD  DSN=MA. LIB. LOAD, DISP=SHR 
//DATAIN  DD  DSN=6DATAIN ,DISP=SHR 

//MARPTLST  DD  SYSOUT=A,DCB=(RECFM=FBA,LRECL=133,BLKSIZE=3458) 
//MAEMSG  DD  DSN=SPCX. LIB. ERROR. CURRENT, DISP=SHR 
//MASUMLST  DD  DUMMY ,DCB=*. MARPTLST 


where  the  symbolic  parameter  DATAIN  specifies  the  user's  prologue /PDL 
library  described  in  Section  3.3.2. 
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The  DDNAMES  are  used  as  follows: 


DDNAME 

STEPLIB 

DATAIN 

MARPTLST 

MAEMSG 

MASUMLST 


USAGE 


Library  where  MACA  load  module  resides. 

User's  Prologue/PDL  Library.  This  file  must 
be  catalogued. 

Prologue/PDL  report  file  . 

Diagnostic  Error  Message  Library.  This 
file  must  be  catalogued. 

Although  this  report  file  is  not  created,  the 
DD  card  must  be  present  as  shown. 


3.4.2  How  to  Use  MACA  Procedure 


The  example  below  illustrates  the  job  control  statements  required  to 
use  the  Code  Auditor: 

//  EXEC  MACA,DATAIN= 'user. catalogued. pds ' 

//SYSIN  DD  * 


CONTROL  CARDS 


/* 
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SECTION  4 


- PROGRAM  OUTPUTS 


The  Automated  Code  Auditor  creates  one  output,  a print  file,  which 
contains  the  following: 

• Control  Card  Listing 

• Module  Prologue/PDL  Listing 

• Test  Specification  Chart. 

The  control  card  report,  illustrated  in  Figure  4-1,  is  generated  uncondition- 
ally as  the  first  report  in  the  output  file.  A Prologue/PDL  Report,  illustrated 
in  Figure  4-2,  is  created  conditionally  for  each  input  module  at  the  user's 
request.  The  Test  Specification  Chart,  illustrated  in  Figure  4-3,  is  created 
conditionally  for  all  input  modules  at  the  user's  request. 
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CENTRAL  FLOW  CONTROL  PROJECT 
AUTOMATED  CODE  AUDITOR 
NODULE  PROLOGUE  ANALYSIS 
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Figure  4-1.  Control  Card  Listing 
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Figure  4-2.  Prologue/PDL  Report 
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AUTOMATED  CODE  AUDITOR 
TEST  PROCEDURE  ANALYSIS 


****************** ************ ***************************************************** 

* DO  * — INI T -*-■•  — PARAMETER  --  TEST  CASES  - 

‘PATH*  CONSTR  * *1*2*3*4*5*6*7*8* 

44 ******************************************************************** ************ 

» I *!F-TRUE  * THE  ERROR  MESSAGE  WAS  NOT  INTH  ********* 

* ? *IF— FALSE*  THE  ERROR  MESSAGE  WAS  NOT  IN  TH  ********* 

> 3 * IF-TRUE  * AN  ERROR  OCCURRED  ********* 

' \ MF-FALSE*  AN  ERROR  OCCURRED  ********* 

4***4***************************** **********  **************************  ************ 

MODULE^  MARES  DATE=  10/26/78  PAGE  l 


Figure  4-3.  Test  Specifications  Chart 
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SUCTION  5 - diagnostic:; 


Diagnostic  messages  generated  by  the  Code  Auditor  are  described  in  this 
section.  Explanations  of  the  probable  cause  and  solutions  are  included 
in  appropriate  cases.  The  majority  of  these  messages  are  related  to 
analysis  of  Module  Prologue  and  PDL. 
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ERROR 

NUMBER  MESSAGE  TEXT  EXPLANATION 


Invalid  Control  Card  Keyword 
Invalid  Module  Name-Skipping  to 
next  dollar  sign. 

See  Lection  3.1  on  control  card 
format.  A module  name  has  been 
specified  on  a control  card  which 
is  either  less  than  two  characters, 
more  than  eight  characters,  or 
contains  an  illegal  character. 

MA004 

The  following  source  module  is 
empty,  xxxxxx  thus  cannot  be 
analyzed. 

Input  module  xxxxxx  contains  no  data. 

MAO  05 

Missing  or  invalid  keyword  on 
control  card  - skipping  to 
next  dollar  sign. 

See  Section  3.1  on  control  card  format, 
format . 

MA007 

Missing  start  control  card: 
skipping  to  next  dollar  sign. 

See  Section  3.1  on  control  card 
format . 

MAO  08 

Missing  TERM  control  card. 

See  Section  3.1  on  control  card 
format . 

MA009 

The  following  source  module 
is  not  in  the  source  PDS : 

xxxxxx 

MODULE  XXXXXX,  specified  to  be  an- 
alyzed, is  not  in  the  prologue/PDL 
library. 

MA010 

END  PDL  keyword  not  present : 
the  entire  PDL  is  presumed 
missing . 

An  example  of  PDL  including  the  END 

PDL  card  appears  in  Figure  1-2. 

MA011 

IF  keyword  found  before  pre- 
decessor IF  condition 
satisfied. 

An  IF  keyword  appears  in  PDL  with- 
out a matching  ENDIF. 

MA012 

DO-WHILE  keyword  found  before 
predecessor  DO-WHILE  condition 
satisfied. 

A DO-WHILE  keyword  has  appeared  in 

PDL  without  a matching  ENDDO. 

MA013 

ENDDO  found  without  a related 
DO-WHILE  condition. 

Self-explanatory 

MA014 

Number  of  diagnostic  messages 
exceeds  maximum  number. 

More  than  100  diagnostics  have  been 
generated . No  more  will  be  generated 
for  the  module  currently  being 
analyzed . 

MA015 

Error  code  xxxxxx  not  in  error 
message  file 

An  attempt  has  been  made  to  print 
diagnostic  $rror  message  xxxxxx,  which 
is  not  in  the  diagnostic  error  message 
library . 
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ERROR 


NUMBER  MESSAGE  TEXT EXPLANAT ION 


MA016 

Executive  control  table  full- 
remainder  of  commands  ignored. 

More  than  100  MODULE  cards  are  in 
the  control  card  file . The  first 

100  are  recognized. 

MA017 

Control  Cards  were  found 
beyond  the  TERM  $ card  and 
will  be  ignored. 

See  Section  3.1  on  control  card 
format . 

MA018 

Source  text  contains  too 
many  statements 

More  than  1000  statements  have  been 
input  for  a module  prologue/PDL . 

This  module  will  not  be  analyzed. 

MA020 

Predecessor  DO-CASE  end  not 
satisfied. 

A DO-CASE  keyword  has  appeared  in 

PDL  without  a matching  ENDCASE. 

MA021 

ORIF  is  not  a valid  PDL 
keyword 

ORIF  is  a JOVIAL  keyword,  but  is  not 
valid  in  PDL. 

MA022 

PD  Table  overflow 

The  main  table  used  in  creating  test 
specification  charts  has  overflowed. 

MAO  2 4 

Input  cards  exceed  maximum 
of  106  - excess  cards  will 
be  ignored. 

Self-explanatory 

MA025 

Card  contains  an  asterisk  in  CC 

3 with  no  accompanying  prologue 
keywords . 

All  cards  containing  keywords  have  an 
asterisk  in  column  3. 

MA026 

END  prologue  keyword  not 
present.  The  entire  prologue 
is  presumed  missing 

Figure  1-1  contains  a sample  Module 
prologue . 

MA027 

END  PDL  keyword  not  present . 

The  entire  PDL  is  presumed  missing. 
Figure  1-2  contains  sample  PDL 
including  the  END  PDL  card. 

■ 

Prologue  analysis  aborted: 

END  PDL  appears  before  end 
prologue  keyword. 

Input  Modules  should  consist  of  a 
prologue  followed  by  PDL. 

MA029 

Prologue  and  PDL  cards  must 
have  comment  delimeters  in 
columns  1,2,65  and  66. 

Valid  comment  delimeters  are : 
asterisks,  the  character  C,  or  single 
quotes . 

MA-031 

Text  missing  - skipping  to 
next  major  prologue  keyword. 

Prologue  text  should  have  appeared 
where  indicated  by  this  message. 

Figure  1-1  contains  a sample  module 
prologue . 

5-3 


ERROR 

NUMBER 


MESSAGE  TEXT 


One  or  both  of  these  keywords 
is/are  missing:  usage  class 
or  usage  restrictions. 


Duplicate  keyword  (or  mis- 
placed line  of  asterisks)- 
skipping  to  next  major  pro- 
logue keyword. 


Missing  Minor  prologue  key- 
word associated  with  previous 
major  keyword  or  possibly 
a missing  asterisk  in  CC  3- 
skipping  to  next  major 
keyword . 


Not  a major  prologue  keyword 
(or  missing  * in  cc3 )-skipping 
to  next  major  keyword. 


The  line  of  asterisks  which 
begins  the  identification 
section  was  never  found . 


Limit  of  Prologue  Matrix 
exceeded:  Remainder  of  pro- 
logue will  be  ignored. 


Missing  Minor  keyword(s)  in 
module  identification  section. 


Major  Prologue  keyword  not 
locatable.  Called  By- 


Major  Prologue  Keyword  not 
locatable.  Calls- 


Major  Prologue  keyword  not 
locatable.  Core  Requirements 


EXPLANATION 


See  Figure  1-1  for  a sample 
module  prologue . 


Major  prologue  keywords  are  those 
beginning  in  column  eight.  Also, 
the  line  of  asterisks  which 
begins  the  identification  section 
is  considered  a major  keyword. 


Minor  prologue  keywords  begin  in 
columns  other  than  eight.  All 
module  prologue  cards  containing 
keywords  must  have  an  asterisk  in 
column  three. 


A major  prologue  keyword  should  have 
appeared  at  the  location  indicated. 
Major  keywords  begin  in  column  8. 
Additionally,  the  line  of  asterisks 
beginning  the  identification  section 
is  considered  to  be  a major  keyword. 


Self-explanatory 


The  prologue  being  analyzed  contains 
duplicate  keywords  and  text  beyond 
reasonable  limits.  The  portion  of 
the  prologue  preceeding  this  message 
will  be  analyzed. 


'END  Prologue"  refers  to  the  END 
Prologue  card. 


Minor  keywords  begin  in  columns  other 
than  eight.  The  only  major  keyword 
in  the  module  identification  section 
is  the  initial  line  of  asterisks. 
Strange , but  true . 


Self-explanatory 


Self-explanatory 


Self-explanatory 
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EPP.OR 


NUMBER 

ML'jLAGE  TEXT 

EXPLANATION 

MAO  4 3 

Major  Prologue  Keyword  not 

locatable : Dates  of  Coding  & Revisions- 

Se If -explanatory 

MA044 

i 

Major  Prologue  Keyword  not 
locatable:  English  name- 

Self -exp lanatory 

MA045 

Major  Prologue  Keyword  not 
locatable:  Error  handling- 

Self-explanatory 

MA046 

Major  Prologue  Keyword  not 
locatable : Input  data 

Self-explanatory 

MA047 

Major  Prologue  Keyword  not 
locatable : Intermediate  Data- 

Self-explanatory 

MA048 

Major  Prologue  Keyword  not 
locatable:  Limitations/ 

Assumptions- 

Self-explanatory 

MA049 

Major  Prologue  Keyword  not 
locatable:  Location. 

Self-explanatory 

MA050 

Major  Prologue  Keyword  not 
locatable  - Method  narrative- 

Self-explanatory 

MA051 

Major  Prologue  Keyword  not 
locatable : Module  Type 

Self-explanatory 

MA052 

Major  Prologue  Keyword  not 
locatable : Output  data- 

Self-explanatory 

MAO  5 3 

Major  Prologue  Keyword  not 
locatable : Purpose- 

Self -explanatory 

MA054 

Major  Prologue  Keyword  not 
locatable:  Special 

Techniques 

Self-explanatory 

MA055 

Major  Prologue  Keyword  not 
locatable:  Timing  estimate- 

Self-explanatory 
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